Разметка публикаций
Титульная информация
На титульном листе размещаются самые важные данные: автор, переводчик, название, жанр, аннотация, год написания, ещё может присутствовать эпиграф.
Информация о создателях
Если создаваемый документ является художественной книгой или учебником, имя автора(ов) располагается в самом начале. Авторство указывается непосредственно перед строкой со звёздочками (обозначающими название произведения). Несколько авторов перечисляются, через запятую.
Для иностранных авторов дополнительно можно указать переводчика, т.к. качество перевода существенно влияет на восприятие произведения. Если необходимо, то можно указывать и художника иллюстраций. Эта информация отделяется линией
Информация о создателях не является исчерпывающей и отражается для ознакомления читателя. Больше информации можно указать в метаданных.
Название
Название произведения, как вы уже знаете, оформляется надчёркиванием звёздочками *.
Жанр произведения
Указывается сразу после названия так, как определил его автор. Это может быть роман, поэма в стихах, фантастический рассказ и т.д.
Аннотация и предисловия
Если перед основным текстом (названиями частей и глав) встречается предисловие или пролог, то к ним применяется то же правило.
Эпиграф
Эпиграф указывается в виде текстового включения с соответствующим классом epigraph или e — при конвертации он окажется на странице справа.
Если в эпиграфе используется цитата, то она оборачивается в отдельное включение.
Год создания
Год написания произведения традиционно располагается в конце произведения самой последней строкой. Букву г или слово год указывать нет необходимости.
Как указать год и город там где это требуется, например, в дипломе, чтобы выровнялось посередине? Как избежать вёрстки, какую семантику заложить к этой допинфе?
Прочая информация
Если вы хотите разместить какую-либо информацию в тексте перед автором и названием произведения, то её необходимо отделить сплошной подчёркивающей чертой ___. Сюда же добавляется указание на то, что представлен только фрагмент произведения (например, по причине нападок копирастов.) Правила хорошего тона предупреждать читателя о том, что это всего-лишь фрагмент.
Всё, что напрямую не касается понимания произведения, например, подробную информацию описательного характера типа издательства, книжные коды лучше указывать в метаданных вынесенных за пределы произведения в виде отдельного файла.
Поэзия
Поэзия включает в себя стихотворения, поэмы, песни. В отличие от простого текста, стихи основаны на ритме. Чтобы добиться правильного ритма, поэтический текст разделяют на строки и на строфы.
Чтобы не использовать разделитель-паузу ~~~ поэтические произведения отмечаются классом poem. В этом случае, строфы можно разделять пустой строкой и произведение будет конвертировано правильно.
Произведения для постановки на сцене
Пьесы и сценарии имеют классы:
- piece — постановка
- screenplay — сценарий
Подробно описаны в разделе Разметка постановок.
Как указывать то, что это поэма или сценарий, если это не включение, а целое произведение? Считывать ли указания в жанре?
Упражнения и тесты
Упражнения, задачи, тесты подробно описаны в разделе упражнения и тесты.
Цитирование
Цитирование отражается с помощью текстового включения с классом quote или сокращённо ". Не будем усложнять структуру, автор цитаты, пояснение про автора и источник цитаты отражается в описании включения.
Строчные цитаты
Строчные цитаты оформляются по правилам русского языка: